<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>add_sample_identifier_preparation_data [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_legacy.html">过时</a> / <a href="toc_legacy_identification.html">Identification</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">add_sample_identifier_preparation_data</span><span data-if="c" style="display:none;">T_add_sample_identifier_preparation_data</span><span data-if="cpp" style="display:none;">AddSampleIdentifierPreparationData</span><span data-if="dotnet" style="display:none;">AddSampleIdentifierPreparationData</span><span data-if="python" style="display:none;">add_sample_identifier_preparation_data</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">add_sample_identifier_preparation_data</span><span data-if="c" style="display:none;">T_add_sample_identifier_preparation_data</span><span data-if="cpp" style="display:none;">AddSampleIdentifierPreparationData</span><span data-if="dotnet" style="display:none;">AddSampleIdentifierPreparationData</span><span data-if="python" style="display:none;">add_sample_identifier_preparation_data</span></code> — Add preparation data to an existing sample identifier.
</p>
<h2>警告</h2>
<p><b><code><span data-if="hdevelop" style="display:inline">add_sample_identifier_preparation_data</span><span data-if="c" style="display:none">add_sample_identifier_preparation_data</span><span data-if="cpp" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="com" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="dotnet" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="python" style="display:none">add_sample_identifier_preparation_data</span></code> is obsolete and is only provided for
reasons of backward compatibility. New applications should use 该算子s
for Deep-Learning-based classification instead, for details see
<a href="toc_deeplearning_classification.html">Deep Learning / Classification</a>.</b></p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>add_sample_identifier_preparation_data</b>(<a href="#SampleImage"><i>SampleImage</i></a> :  : <a href="#SampleIdentifier"><i>SampleIdentifier</i></a>, <a href="#ObjectIdx"><i>ObjectIdx</i></a>, <a href="#GenParamName"><i>GenParamName</i></a>, <a href="#GenParamValue"><i>GenParamValue</i></a> : <a href="#ObjectSampleIdx"><i>ObjectSampleIdx</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_add_sample_identifier_preparation_data</b>(const Hobject <a href="#SampleImage"><i>SampleImage</i></a>, const Htuple <a href="#SampleIdentifier"><i>SampleIdentifier</i></a>, const Htuple <a href="#ObjectIdx"><i>ObjectIdx</i></a>, const Htuple <a href="#GenParamName"><i>GenParamName</i></a>, const Htuple <a href="#GenParamValue"><i>GenParamValue</i></a>, Htuple* <a href="#ObjectSampleIdx"><i>ObjectSampleIdx</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>AddSampleIdentifierPreparationData</b>(const HObject&amp; <a href="#SampleImage"><i>SampleImage</i></a>, const HTuple&amp; <a href="#SampleIdentifier"><i>SampleIdentifier</i></a>, const HTuple&amp; <a href="#ObjectIdx"><i>ObjectIdx</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>, HTuple* <a href="#ObjectSampleIdx"><i>ObjectSampleIdx</i></a>)</code></p>
<p>
<code>Hlong <a href="HImage.html">HImage</a>::<b>AddSampleIdentifierPreparationData</b>(const HSampleIdentifier&amp; <a href="#SampleIdentifier"><i>SampleIdentifier</i></a>, const HTuple&amp; <a href="#ObjectIdx"><i>ObjectIdx</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>) const</code></p>
<p>
<code>Hlong <a href="HImage.html">HImage</a>::<b>AddSampleIdentifierPreparationData</b>(const HSampleIdentifier&amp; <a href="#SampleIdentifier"><i>SampleIdentifier</i></a>, Hlong <a href="#ObjectIdx"><i>ObjectIdx</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>) const</code></p>
<p>
<code>Hlong <a href="HSampleIdentifier.html">HSampleIdentifier</a>::<b>AddSampleIdentifierPreparationData</b>(const HImage&amp; <a href="#SampleImage"><i>SampleImage</i></a>, const HTuple&amp; <a href="#ObjectIdx"><i>ObjectIdx</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>) const</code></p>
<p>
<code>Hlong <a href="HSampleIdentifier.html">HSampleIdentifier</a>::<b>AddSampleIdentifierPreparationData</b>(const HImage&amp; <a href="#SampleImage"><i>SampleImage</i></a>, Hlong <a href="#ObjectIdx"><i>ObjectIdx</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>) const</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>AddSampleIdentifierPreparationData</b>(<a href="HObject.html">HObject</a> <a href="#SampleImage"><i>sampleImage</i></a>, <a href="HTuple.html">HTuple</a> <a href="#SampleIdentifier"><i>sampleIdentifier</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ObjectIdx"><i>objectIdx</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#ObjectSampleIdx"><i>objectSampleIdx</i></a>)</code></p>
<p>
<code>int <a href="HImage.html">HImage</a>.<b>AddSampleIdentifierPreparationData</b>(<a href="HSampleIdentifier.html">HSampleIdentifier</a> <a href="#SampleIdentifier"><i>sampleIdentifier</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ObjectIdx"><i>objectIdx</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>)</code></p>
<p>
<code>int <a href="HImage.html">HImage</a>.<b>AddSampleIdentifierPreparationData</b>(<a href="HSampleIdentifier.html">HSampleIdentifier</a> <a href="#SampleIdentifier"><i>sampleIdentifier</i></a>, int <a href="#ObjectIdx"><i>objectIdx</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>)</code></p>
<p>
<code>int <a href="HSampleIdentifier.html">HSampleIdentifier</a>.<b>AddSampleIdentifierPreparationData</b>(<a href="HImage.html">HImage</a> <a href="#SampleImage"><i>sampleImage</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ObjectIdx"><i>objectIdx</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>)</code></p>
<p>
<code>int <a href="HSampleIdentifier.html">HSampleIdentifier</a>.<b>AddSampleIdentifierPreparationData</b>(<a href="HImage.html">HImage</a> <a href="#SampleImage"><i>sampleImage</i></a>, int <a href="#ObjectIdx"><i>objectIdx</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>add_sample_identifier_preparation_data</b>(<a href="#SampleImage"><i>sample_image</i></a>: HObject, <a href="#SampleIdentifier"><i>sample_identifier</i></a>: HHandle, <a href="#ObjectIdx"><i>object_idx</i></a>: Union[int, str], <a href="#GenParamName"><i>gen_param_name</i></a>: Sequence[str], <a href="#GenParamValue"><i>gen_param_value</i></a>: Sequence[Union[str, int, float]]) -&gt; int</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">add_sample_identifier_preparation_data</span><span data-if="c" style="display:none">add_sample_identifier_preparation_data</span><span data-if="cpp" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="com" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="dotnet" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="python" style="display:none">add_sample_identifier_preparation_data</span></code> adds preparation data to an
existing sample identifier. This is a prerequisite for the preparation of
the sample identifier with 该算子 <a href="prepare_sample_identifier.html"><code><span data-if="hdevelop" style="display:inline">prepare_sample_identifier</span><span data-if="c" style="display:none">prepare_sample_identifier</span><span data-if="cpp" style="display:none">PrepareSampleIdentifier</span><span data-if="com" style="display:none">PrepareSampleIdentifier</span><span data-if="dotnet" style="display:none">PrepareSampleIdentifier</span><span data-if="python" style="display:none">prepare_sample_identifier</span></code></a>.
</p>
<p>For an explanation of the concept of sample-based identification
see the introduction of chapter <a href="toc_legacy_identification.html">Legacy / Identification</a>.
</p>
<p>To achieve the maximum identification rate, the internal data structure of
the sample identifier must be adapted to the objects to be identified. For
this, it is useful to provide sample images of all kinds of objects to be
identified.
</p>
<p>With each call of <code><span data-if="hdevelop" style="display:inline">add_sample_identifier_preparation_data</span><span data-if="c" style="display:none">add_sample_identifier_preparation_data</span><span data-if="cpp" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="com" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="dotnet" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="python" style="display:none">add_sample_identifier_preparation_data</span></code>, features
of one <a href="#SampleImage"><i><code><span data-if="hdevelop" style="display:inline">SampleImage</span><span data-if="c" style="display:none">SampleImage</span><span data-if="cpp" style="display:none">SampleImage</span><span data-if="com" style="display:none">SampleImage</span><span data-if="dotnet" style="display:none">sampleImage</span><span data-if="python" style="display:none">sample_image</span></code></i></a> are added to the <a href="#SampleIdentifier"><i><code><span data-if="hdevelop" style="display:inline">SampleIdentifier</span><span data-if="c" style="display:none">SampleIdentifier</span><span data-if="cpp" style="display:none">SampleIdentifier</span><span data-if="com" style="display:none">SampleIdentifier</span><span data-if="dotnet" style="display:none">sampleIdentifier</span><span data-if="python" style="display:none">sample_identifier</span></code></i></a>. The
complete preparation data, which consists of all features of all sample
images that have been added to the sample identifier with multiple calls of
<code><span data-if="hdevelop" style="display:inline">add_sample_identifier_preparation_data</span><span data-if="c" style="display:none">add_sample_identifier_preparation_data</span><span data-if="cpp" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="com" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="dotnet" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="python" style="display:none">add_sample_identifier_preparation_data</span></code>, should cover
</p>
<ul>

<li>
<p> all kinds of objects to be identified and
</p>
</li>
<li>
<p> all different views of the objects that may appear during the
identification process, sampled to at least 45 degrees.
</p>
</li>
</ul>
<p>The domain of the <a href="#SampleImage"><i><code><span data-if="hdevelop" style="display:inline">SampleImage</span><span data-if="c" style="display:none">SampleImage</span><span data-if="cpp" style="display:none">SampleImage</span><span data-if="com" style="display:none">SampleImage</span><span data-if="dotnet" style="display:none">sampleImage</span><span data-if="python" style="display:none">sample_image</span></code></i></a> should be reduced to the object,
which is visible in the image. This is necessary to avoid that the
<a href="#SampleIdentifier"><i><code><span data-if="hdevelop" style="display:inline">SampleIdentifier</span><span data-if="c" style="display:none">SampleIdentifier</span><span data-if="cpp" style="display:none">SampleIdentifier</span><span data-if="com" style="display:none">SampleIdentifier</span><span data-if="dotnet" style="display:none">sampleIdentifier</span><span data-if="python" style="display:none">sample_identifier</span></code></i></a> is adapted to the background of the sample images.
</p>
<p>If you cannot provide preparation data that fulfills all of the above
mentioned requirements, the sample identifier may be prepared as well, but
the identification rate may be slightly worse.
</p>
<p>Note that you must provide RGB color images, if the generic parameter
<i><span data-if="hdevelop" style="display:inline">'add_color_info'</span><span data-if="c" style="display:none">"add_color_info"</span><span data-if="cpp" style="display:none">"add_color_info"</span><span data-if="com" style="display:none">"add_color_info"</span><span data-if="dotnet" style="display:none">"add_color_info"</span><span data-if="python" style="display:none">"add_color_info"</span></i> has been set to <i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i> in
<a href="create_sample_identifier.html"><code><span data-if="hdevelop" style="display:inline">create_sample_identifier</span><span data-if="c" style="display:none">create_sample_identifier</span><span data-if="cpp" style="display:none">CreateSampleIdentifier</span><span data-if="com" style="display:none">CreateSampleIdentifier</span><span data-if="dotnet" style="display:none">CreateSampleIdentifier</span><span data-if="python" style="display:none">create_sample_identifier</span></code></a>.
</p>
<p>Ideally, the images used for preparation and training (see
<a href="add_sample_identifier_training_data.html"><code><span data-if="hdevelop" style="display:inline">add_sample_identifier_training_data</span><span data-if="c" style="display:none">add_sample_identifier_training_data</span><span data-if="cpp" style="display:none">AddSampleIdentifierTrainingData</span><span data-if="com" style="display:none">AddSampleIdentifierTrainingData</span><span data-if="dotnet" style="display:none">AddSampleIdentifierTrainingData</span><span data-if="python" style="display:none">add_sample_identifier_training_data</span></code></a> and
<a href="train_sample_identifier.html"><code><span data-if="hdevelop" style="display:inline">train_sample_identifier</span><span data-if="c" style="display:none">train_sample_identifier</span><span data-if="cpp" style="display:none">TrainSampleIdentifier</span><span data-if="com" style="display:none">TrainSampleIdentifier</span><span data-if="dotnet" style="display:none">TrainSampleIdentifier</span><span data-if="python" style="display:none">train_sample_identifier</span></code></a>) are identical.  This can easily be realized
by reusing the preparation data for the training of the
<a href="#SampleIdentifier"><i><code><span data-if="hdevelop" style="display:inline">SampleIdentifier</span><span data-if="c" style="display:none">SampleIdentifier</span><span data-if="cpp" style="display:none">SampleIdentifier</span><span data-if="com" style="display:none">SampleIdentifier</span><span data-if="dotnet" style="display:none">sampleIdentifier</span><span data-if="python" style="display:none">sample_identifier</span></code></i></a>. To be able to reuse the preparation data, the
index of the object must be given in <a href="#ObjectIdx"><i><code><span data-if="hdevelop" style="display:inline">ObjectIdx</span><span data-if="c" style="display:none">ObjectIdx</span><span data-if="cpp" style="display:none">ObjectIdx</span><span data-if="com" style="display:none">ObjectIdx</span><span data-if="dotnet" style="display:none">objectIdx</span><span data-if="python" style="display:none">object_idx</span></code></i></a>. Otherwise, the
<a href="#ObjectIdx"><i><code><span data-if="hdevelop" style="display:inline">ObjectIdx</span><span data-if="c" style="display:none">ObjectIdx</span><span data-if="cpp" style="display:none">ObjectIdx</span><span data-if="com" style="display:none">ObjectIdx</span><span data-if="dotnet" style="display:none">objectIdx</span><span data-if="python" style="display:none">object_idx</span></code></i></a> can be set to <i><span data-if="hdevelop" style="display:inline">'unknown'</span><span data-if="c" style="display:none">"unknown"</span><span data-if="cpp" style="display:none">"unknown"</span><span data-if="com" style="display:none">"unknown"</span><span data-if="dotnet" style="display:none">"unknown"</span><span data-if="python" style="display:none">"unknown"</span></i>.  See
<a href="prepare_sample_identifier.html"><code><span data-if="hdevelop" style="display:inline">prepare_sample_identifier</span><span data-if="c" style="display:none">prepare_sample_identifier</span><span data-if="cpp" style="display:none">PrepareSampleIdentifier</span><span data-if="com" style="display:none">PrepareSampleIdentifier</span><span data-if="dotnet" style="display:none">PrepareSampleIdentifier</span><span data-if="python" style="display:none">prepare_sample_identifier</span></code></a> for an explanation on how to reuse
preparation data for the training of the sample identifier.
</p>
<p>The following generic parameters can be used to influence the behavior of
该算子 <code><span data-if="hdevelop" style="display:inline">add_sample_identifier_preparation_data</span><span data-if="c" style="display:none">add_sample_identifier_preparation_data</span><span data-if="cpp" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="com" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="dotnet" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="python" style="display:none">add_sample_identifier_preparation_data</span></code>.  These
parameters and their corresponding values can be specified by using
<a href="#GenParamName"><i><code><span data-if="hdevelop" style="display:inline">GenParamName</span><span data-if="c" style="display:none">GenParamName</span><span data-if="cpp" style="display:none">GenParamName</span><span data-if="com" style="display:none">GenParamName</span><span data-if="dotnet" style="display:none">genParamName</span><span data-if="python" style="display:none">gen_param_name</span></code></i></a> and <a href="#GenParamValue"><i><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></i></a>, respectively.  The
following values for <a href="#GenParamName"><i><code><span data-if="hdevelop" style="display:inline">GenParamName</span><span data-if="c" style="display:none">GenParamName</span><span data-if="cpp" style="display:none">GenParamName</span><span data-if="com" style="display:none">GenParamName</span><span data-if="dotnet" style="display:none">genParamName</span><span data-if="python" style="display:none">gen_param_name</span></code></i></a> are possible:
</p>
<dl class="generic">


<dt><b><i><span data-if="hdevelop" style="display:inline">'image_resize_method'</span><span data-if="c" style="display:none">"image_resize_method"</span><span data-if="cpp" style="display:none">"image_resize_method"</span><span data-if="com" style="display:none">"image_resize_method"</span><span data-if="dotnet" style="display:none">"image_resize_method"</span><span data-if="python" style="display:none">"image_resize_method"</span></i>:</b></dt>
<dd>
<p>
 See
<a href="create_sample_identifier.html"><code><span data-if="hdevelop" style="display:inline">create_sample_identifier</span><span data-if="c" style="display:none">create_sample_identifier</span><span data-if="cpp" style="display:none">CreateSampleIdentifier</span><span data-if="com" style="display:none">CreateSampleIdentifier</span><span data-if="dotnet" style="display:none">CreateSampleIdentifier</span><span data-if="python" style="display:none">create_sample_identifier</span></code></a> for a description of this parameter.
</p>
<p><i>List of values:</i> <i><span data-if="hdevelop" style="display:inline">'none'</span><span data-if="c" style="display:none">"none"</span><span data-if="cpp" style="display:none">"none"</span><span data-if="com" style="display:none">"none"</span><span data-if="dotnet" style="display:none">"none"</span><span data-if="python" style="display:none">"none"</span></i>, <i><span data-if="hdevelop" style="display:inline">'scale_factor'</span><span data-if="c" style="display:none">"scale_factor"</span><span data-if="cpp" style="display:none">"scale_factor"</span><span data-if="com" style="display:none">"scale_factor"</span><span data-if="dotnet" style="display:none">"scale_factor"</span><span data-if="python" style="display:none">"scale_factor"</span></i>,
<i><span data-if="hdevelop" style="display:inline">'subsampling_step'</span><span data-if="c" style="display:none">"subsampling_step"</span><span data-if="cpp" style="display:none">"subsampling_step"</span><span data-if="com" style="display:none">"subsampling_step"</span><span data-if="dotnet" style="display:none">"subsampling_step"</span><span data-if="python" style="display:none">"subsampling_step"</span></i>, <i><span data-if="hdevelop" style="display:inline">'image_area'</span><span data-if="c" style="display:none">"image_area"</span><span data-if="cpp" style="display:none">"image_area"</span><span data-if="com" style="display:none">"image_area"</span><span data-if="dotnet" style="display:none">"image_area"</span><span data-if="python" style="display:none">"image_area"</span></i>
</p>
<p><i>Default value:</i> If the <i><span data-if="hdevelop" style="display:inline">'image_resize_method'</span><span data-if="c" style="display:none">"image_resize_method"</span><span data-if="cpp" style="display:none">"image_resize_method"</span><span data-if="com" style="display:none">"image_resize_method"</span><span data-if="dotnet" style="display:none">"image_resize_method"</span><span data-if="python" style="display:none">"image_resize_method"</span></i> is not set
explicitly by this operator, the value that has been set with
<a href="create_sample_identifier.html"><code><span data-if="hdevelop" style="display:inline">create_sample_identifier</span><span data-if="c" style="display:none">create_sample_identifier</span><span data-if="cpp" style="display:none">CreateSampleIdentifier</span><span data-if="com" style="display:none">CreateSampleIdentifier</span><span data-if="dotnet" style="display:none">CreateSampleIdentifier</span><span data-if="python" style="display:none">create_sample_identifier</span></code></a> or <a href="set_sample_identifier_param.html"><code><span data-if="hdevelop" style="display:inline">set_sample_identifier_param</span><span data-if="c" style="display:none">set_sample_identifier_param</span><span data-if="cpp" style="display:none">SetSampleIdentifierParam</span><span data-if="com" style="display:none">SetSampleIdentifierParam</span><span data-if="dotnet" style="display:none">SetSampleIdentifierParam</span><span data-if="python" style="display:none">set_sample_identifier_param</span></code></a>
will be used.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'image_resize_value'</span><span data-if="c" style="display:none">"image_resize_value"</span><span data-if="cpp" style="display:none">"image_resize_value"</span><span data-if="com" style="display:none">"image_resize_value"</span><span data-if="dotnet" style="display:none">"image_resize_value"</span><span data-if="python" style="display:none">"image_resize_value"</span></i>:</b></dt>
<dd>
<p>
 See <a href="create_sample_identifier.html"><code><span data-if="hdevelop" style="display:inline">create_sample_identifier</span><span data-if="c" style="display:none">create_sample_identifier</span><span data-if="cpp" style="display:none">CreateSampleIdentifier</span><span data-if="com" style="display:none">CreateSampleIdentifier</span><span data-if="dotnet" style="display:none">CreateSampleIdentifier</span><span data-if="python" style="display:none">create_sample_identifier</span></code></a>
for a description of this parameter.
</p>
<p><i>Suggested values:</i> <i>0.25</i>, <i>0.5</i>, <i>1.0</i>,
<i>2</i>, <i>3</i>, <i>4</i>
</p>
<p><i>Default value:</i> If the <i><span data-if="hdevelop" style="display:inline">'image_resize_value'</span><span data-if="c" style="display:none">"image_resize_value"</span><span data-if="cpp" style="display:none">"image_resize_value"</span><span data-if="com" style="display:none">"image_resize_value"</span><span data-if="dotnet" style="display:none">"image_resize_value"</span><span data-if="python" style="display:none">"image_resize_value"</span></i> is not set
explicitly by this operator, the value that has been set with
<a href="create_sample_identifier.html"><code><span data-if="hdevelop" style="display:inline">create_sample_identifier</span><span data-if="c" style="display:none">create_sample_identifier</span><span data-if="cpp" style="display:none">CreateSampleIdentifier</span><span data-if="com" style="display:none">CreateSampleIdentifier</span><span data-if="dotnet" style="display:none">CreateSampleIdentifier</span><span data-if="python" style="display:none">create_sample_identifier</span></code></a> or <a href="set_sample_identifier_param.html"><code><span data-if="hdevelop" style="display:inline">set_sample_identifier_param</span><span data-if="c" style="display:none">set_sample_identifier_param</span><span data-if="cpp" style="display:none">SetSampleIdentifierParam</span><span data-if="com" style="display:none">SetSampleIdentifierParam</span><span data-if="dotnet" style="display:none">SetSampleIdentifierParam</span><span data-if="python" style="display:none">set_sample_identifier_param</span></code></a>
will be used.
</p>
</dd>
</dl>
<p><code><span data-if="hdevelop" style="display:inline">add_sample_identifier_preparation_data</span><span data-if="c" style="display:none">add_sample_identifier_preparation_data</span><span data-if="cpp" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="com" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="dotnet" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="python" style="display:none">add_sample_identifier_preparation_data</span></code> returns the object sample
index of the preparation sample given in <a href="#SampleImage"><i><code><span data-if="hdevelop" style="display:inline">SampleImage</span><span data-if="c" style="display:none">SampleImage</span><span data-if="cpp" style="display:none">SampleImage</span><span data-if="com" style="display:none">SampleImage</span><span data-if="dotnet" style="display:none">sampleImage</span><span data-if="python" style="display:none">sample_image</span></code></i></a>. This index
can, e.g., be used to remove this sample from the preparation data, if the
sample identifier should be prepared based on a different set of
preparation data.
</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  
    <li>Automatically parallelized on internal data level.</li>
  
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="SampleImage" class="parname"><b><code><span data-if="hdevelop" style="display:inline">SampleImage</span><span data-if="c" style="display:none">SampleImage</span><span data-if="cpp" style="display:none">SampleImage</span><span data-if="com" style="display:none">SampleImage</span><span data-if="dotnet" style="display:none">sampleImage</span><span data-if="python" style="display:none">sample_image</span></code></b> (input_object)  </span><span>(multichannel-)image <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte)</span>
</div>
<p class="pardesc">Image that shows an object.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="SampleIdentifier" class="parname"><b><code><span data-if="hdevelop" style="display:inline">SampleIdentifier</span><span data-if="c" style="display:none">SampleIdentifier</span><span data-if="cpp" style="display:none">SampleIdentifier</span><span data-if="com" style="display:none">SampleIdentifier</span><span data-if="dotnet" style="display:none">sampleIdentifier</span><span data-if="python" style="display:none">sample_identifier</span></code></b> (input_control)  </span><span>sample_identifier <code>→</code> <span data-if="dotnet" style="display:none"><a href="HSampleIdentifier.html">HSampleIdentifier</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">HHandle</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Handle of the sample identifier.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ObjectIdx" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ObjectIdx</span><span data-if="c" style="display:none">ObjectIdx</span><span data-if="cpp" style="display:none">ObjectIdx</span><span data-if="com" style="display:none">ObjectIdx</span><span data-if="dotnet" style="display:none">objectIdx</span><span data-if="python" style="display:none">object_idx</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Union[int, str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer / </span><span data-if="hdevelop" style="display:inline">string)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long / </span><span data-if="dotnet" style="display:none">string)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i> / </span><span data-if="cpp" style="display:none">HString)</span><span data-if="c" style="display:none"> (<i>Hlong</i> / </span><span data-if="c" style="display:none">char*)</span></span>
</div>
<p class="pardesc">Index of the object visible in the <a href="#SampleImage"><i><code><span data-if="hdevelop" style="display:inline">SampleImage</span><span data-if="c" style="display:none">SampleImage</span><span data-if="cpp" style="display:none">SampleImage</span><span data-if="com" style="display:none">SampleImage</span><span data-if="dotnet" style="display:none">sampleImage</span><span data-if="python" style="display:none">sample_image</span></code></i></a>.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'unknown'</span>
    <span data-if="c" style="display:none">"unknown"</span>
    <span data-if="cpp" style="display:none">"unknown"</span>
    <span data-if="com" style="display:none">"unknown"</span>
    <span data-if="dotnet" style="display:none">"unknown"</span>
    <span data-if="python" style="display:none">"unknown"</span>
</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'unknown'</span><span data-if="c" style="display:none">"unknown"</span><span data-if="cpp" style="display:none">"unknown"</span><span data-if="com" style="display:none">"unknown"</span><span data-if="dotnet" style="display:none">"unknown"</span><span data-if="python" style="display:none">"unknown"</span>, 0, 1, 2, 3, 4, 5</p>
</div>
  <div class="par">
<div class="parhead">
<span id="GenParamName" class="parname"><b><code><span data-if="hdevelop" style="display:inline">GenParamName</span><span data-if="c" style="display:none">GenParamName</span><span data-if="cpp" style="display:none">GenParamName</span><span data-if="com" style="display:none">GenParamName</span><span data-if="dotnet" style="display:none">genParamName</span><span data-if="python" style="display:none">gen_param_name</span></code></b> (input_control)  </span><span>attribute.name-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Generic parameter name.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>[]</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'image_resize_method'</span><span data-if="c" style="display:none">"image_resize_method"</span><span data-if="cpp" style="display:none">"image_resize_method"</span><span data-if="com" style="display:none">"image_resize_method"</span><span data-if="dotnet" style="display:none">"image_resize_method"</span><span data-if="python" style="display:none">"image_resize_method"</span>, <span data-if="hdevelop" style="display:inline">'image_resize_value'</span><span data-if="c" style="display:none">"image_resize_value"</span><span data-if="cpp" style="display:none">"image_resize_value"</span><span data-if="com" style="display:none">"image_resize_value"</span><span data-if="dotnet" style="display:none">"image_resize_value"</span><span data-if="python" style="display:none">"image_resize_value"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="GenParamValue" class="parname"><b><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></b> (input_control)  </span><span>attribute.value-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[Union[str, int, float]]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real / </span><span data-if="hdevelop" style="display:inline">string / </span><span data-if="hdevelop" style="display:inline">integer)</span><span data-if="dotnet" style="display:none"> (<i>double</i> / </span><span data-if="dotnet" style="display:none">string / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>double</i> / </span><span data-if="cpp" style="display:none">HString / </span><span data-if="cpp" style="display:none">Hlong)</span><span data-if="c" style="display:none"> (<i>double</i> / </span><span data-if="c" style="display:none">char* / </span><span data-if="c" style="display:none">Hlong)</span></span>
</div>
<p class="pardesc">Generic parameter value.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>[]</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'none'</span><span data-if="c" style="display:none">"none"</span><span data-if="cpp" style="display:none">"none"</span><span data-if="com" style="display:none">"none"</span><span data-if="dotnet" style="display:none">"none"</span><span data-if="python" style="display:none">"none"</span>, <span data-if="hdevelop" style="display:inline">'scale_factor'</span><span data-if="c" style="display:none">"scale_factor"</span><span data-if="cpp" style="display:none">"scale_factor"</span><span data-if="com" style="display:none">"scale_factor"</span><span data-if="dotnet" style="display:none">"scale_factor"</span><span data-if="python" style="display:none">"scale_factor"</span>, <span data-if="hdevelop" style="display:inline">'subsampling_step'</span><span data-if="c" style="display:none">"subsampling_step"</span><span data-if="cpp" style="display:none">"subsampling_step"</span><span data-if="com" style="display:none">"subsampling_step"</span><span data-if="dotnet" style="display:none">"subsampling_step"</span><span data-if="python" style="display:none">"subsampling_step"</span>, <span data-if="hdevelop" style="display:inline">'image_area'</span><span data-if="c" style="display:none">"image_area"</span><span data-if="cpp" style="display:none">"image_area"</span><span data-if="com" style="display:none">"image_area"</span><span data-if="dotnet" style="display:none">"image_area"</span><span data-if="python" style="display:none">"image_area"</span>, 0.25, 0.5, 0.75, 1.0, 2, 3, 4</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ObjectSampleIdx" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ObjectSampleIdx</span><span data-if="c" style="display:none">ObjectSampleIdx</span><span data-if="cpp" style="display:none">ObjectSampleIdx</span><span data-if="com" style="display:none">ObjectSampleIdx</span><span data-if="dotnet" style="display:none">objectSampleIdx</span><span data-if="python" style="display:none">object_sample_idx</span></code></b> (output_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Index of the object sample.</p>
</div>
<h2 id="sec_result">结果</h2>
<p>如果参数均有效，算子
<code><span data-if="hdevelop" style="display:inline">add_sample_identifier_preparation_data</span><span data-if="c" style="display:none">add_sample_identifier_preparation_data</span><span data-if="cpp" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="com" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="dotnet" style="display:none">AddSampleIdentifierPreparationData</span><span data-if="python" style="display:none">add_sample_identifier_preparation_data</span></code> 返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    .  If
necessary an exception is raised.  </p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="create_sample_identifier.html"><span data-if="hdevelop" style="display:inline">create_sample_identifier</span><span data-if="c" style="display:none">create_sample_identifier</span><span data-if="cpp" style="display:none">CreateSampleIdentifier</span><span data-if="com" style="display:none">CreateSampleIdentifier</span><span data-if="dotnet" style="display:none">CreateSampleIdentifier</span><span data-if="python" style="display:none">create_sample_identifier</span></a></code>, 
<code><a href="read_sample_identifier.html"><span data-if="hdevelop" style="display:inline">read_sample_identifier</span><span data-if="c" style="display:none">read_sample_identifier</span><span data-if="cpp" style="display:none">ReadSampleIdentifier</span><span data-if="com" style="display:none">ReadSampleIdentifier</span><span data-if="dotnet" style="display:none">ReadSampleIdentifier</span><span data-if="python" style="display:none">read_sample_identifier</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="prepare_sample_identifier.html"><span data-if="hdevelop" style="display:inline">prepare_sample_identifier</span><span data-if="c" style="display:none">prepare_sample_identifier</span><span data-if="cpp" style="display:none">PrepareSampleIdentifier</span><span data-if="com" style="display:none">PrepareSampleIdentifier</span><span data-if="dotnet" style="display:none">PrepareSampleIdentifier</span><span data-if="python" style="display:none">prepare_sample_identifier</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="read_sample_identifier.html"><span data-if="hdevelop" style="display:inline">read_sample_identifier</span><span data-if="c" style="display:none">read_sample_identifier</span><span data-if="cpp" style="display:none">ReadSampleIdentifier</span><span data-if="com" style="display:none">ReadSampleIdentifier</span><span data-if="dotnet" style="display:none">ReadSampleIdentifier</span><span data-if="python" style="display:none">read_sample_identifier</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="add_sample_identifier_training_data.html"><span data-if="hdevelop" style="display:inline">add_sample_identifier_training_data</span><span data-if="c" style="display:none">add_sample_identifier_training_data</span><span data-if="cpp" style="display:none">AddSampleIdentifierTrainingData</span><span data-if="com" style="display:none">AddSampleIdentifierTrainingData</span><span data-if="dotnet" style="display:none">AddSampleIdentifierTrainingData</span><span data-if="python" style="display:none">add_sample_identifier_training_data</span></a></code>, 
<code><a href="train_sample_identifier.html"><span data-if="hdevelop" style="display:inline">train_sample_identifier</span><span data-if="c" style="display:none">train_sample_identifier</span><span data-if="cpp" style="display:none">TrainSampleIdentifier</span><span data-if="com" style="display:none">TrainSampleIdentifier</span><span data-if="dotnet" style="display:none">TrainSampleIdentifier</span><span data-if="python" style="display:none">train_sample_identifier</span></a></code>, 
<code><a href="apply_sample_identifier.html"><span data-if="hdevelop" style="display:inline">apply_sample_identifier</span><span data-if="c" style="display:none">apply_sample_identifier</span><span data-if="cpp" style="display:none">ApplySampleIdentifier</span><span data-if="com" style="display:none">ApplySampleIdentifier</span><span data-if="dotnet" style="display:none">ApplySampleIdentifier</span><span data-if="python" style="display:none">apply_sample_identifier</span></a></code>, 
<code><a href="set_sample_identifier_param.html"><span data-if="hdevelop" style="display:inline">set_sample_identifier_param</span><span data-if="c" style="display:none">set_sample_identifier_param</span><span data-if="cpp" style="display:none">SetSampleIdentifierParam</span><span data-if="com" style="display:none">SetSampleIdentifierParam</span><span data-if="dotnet" style="display:none">SetSampleIdentifierParam</span><span data-if="python" style="display:none">set_sample_identifier_param</span></a></code>, 
<code><a href="get_sample_identifier_param.html"><span data-if="hdevelop" style="display:inline">get_sample_identifier_param</span><span data-if="c" style="display:none">get_sample_identifier_param</span><span data-if="cpp" style="display:none">GetSampleIdentifierParam</span><span data-if="com" style="display:none">GetSampleIdentifierParam</span><span data-if="dotnet" style="display:none">GetSampleIdentifierParam</span><span data-if="python" style="display:none">get_sample_identifier_param</span></a></code>, 
<code><a href="get_sample_identifier_object_info.html"><span data-if="hdevelop" style="display:inline">get_sample_identifier_object_info</span><span data-if="c" style="display:none">get_sample_identifier_object_info</span><span data-if="cpp" style="display:none">GetSampleIdentifierObjectInfo</span><span data-if="com" style="display:none">GetSampleIdentifierObjectInfo</span><span data-if="dotnet" style="display:none">GetSampleIdentifierObjectInfo</span><span data-if="python" style="display:none">get_sample_identifier_object_info</span></a></code>, 
<code><a href="remove_sample_identifier_preparation_data.html"><span data-if="hdevelop" style="display:inline">remove_sample_identifier_preparation_data</span><span data-if="c" style="display:none">remove_sample_identifier_preparation_data</span><span data-if="cpp" style="display:none">RemoveSampleIdentifierPreparationData</span><span data-if="com" style="display:none">RemoveSampleIdentifierPreparationData</span><span data-if="dotnet" style="display:none">RemoveSampleIdentifierPreparationData</span><span data-if="python" style="display:none">remove_sample_identifier_preparation_data</span></a></code>, 
<code><a href="remove_sample_identifier_training_data.html"><span data-if="hdevelop" style="display:inline">remove_sample_identifier_training_data</span><span data-if="c" style="display:none">remove_sample_identifier_training_data</span><span data-if="cpp" style="display:none">RemoveSampleIdentifierTrainingData</span><span data-if="com" style="display:none">RemoveSampleIdentifierTrainingData</span><span data-if="dotnet" style="display:none">RemoveSampleIdentifierTrainingData</span><span data-if="python" style="display:none">remove_sample_identifier_training_data</span></a></code>, 
<code><a href="write_sample_identifier.html"><span data-if="hdevelop" style="display:inline">write_sample_identifier</span><span data-if="c" style="display:none">write_sample_identifier</span><span data-if="cpp" style="display:none">WriteSampleIdentifier</span><span data-if="com" style="display:none">WriteSampleIdentifier</span><span data-if="dotnet" style="display:none">WriteSampleIdentifier</span><span data-if="python" style="display:none">write_sample_identifier</span></a></code>, 
<code><a href="serialize_sample_identifier.html"><span data-if="hdevelop" style="display:inline">serialize_sample_identifier</span><span data-if="c" style="display:none">serialize_sample_identifier</span><span data-if="cpp" style="display:none">SerializeSampleIdentifier</span><span data-if="com" style="display:none">SerializeSampleIdentifier</span><span data-if="dotnet" style="display:none">SerializeSampleIdentifier</span><span data-if="python" style="display:none">serialize_sample_identifier</span></a></code>, 
<code><a href="deserialize_sample_identifier.html"><span data-if="hdevelop" style="display:inline">deserialize_sample_identifier</span><span data-if="c" style="display:none">deserialize_sample_identifier</span><span data-if="cpp" style="display:none">DeserializeSampleIdentifier</span><span data-if="com" style="display:none">DeserializeSampleIdentifier</span><span data-if="dotnet" style="display:none">DeserializeSampleIdentifier</span><span data-if="python" style="display:none">deserialize_sample_identifier</span></a></code>, 
<code><a href="clear_sample_identifier.html"><span data-if="hdevelop" style="display:inline">clear_sample_identifier</span><span data-if="c" style="display:none">clear_sample_identifier</span><span data-if="cpp" style="display:none">ClearSampleIdentifier</span><span data-if="com" style="display:none">ClearSampleIdentifier</span><span data-if="dotnet" style="display:none">ClearSampleIdentifier</span><span data-if="python" style="display:none">clear_sample_identifier</span></a></code>, 
<code><a href="set_sample_identifier_object_info.html"><span data-if="hdevelop" style="display:inline">set_sample_identifier_object_info</span><span data-if="c" style="display:none">set_sample_identifier_object_info</span><span data-if="cpp" style="display:none">SetSampleIdentifierObjectInfo</span><span data-if="com" style="display:none">SetSampleIdentifierObjectInfo</span><span data-if="dotnet" style="display:none">SetSampleIdentifierObjectInfo</span><span data-if="python" style="display:none">set_sample_identifier_object_info</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Matching</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
